home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / gapdemo2.zip / QWKREP.ZIP / LOCAL.TXT next >
Text File  |  1993-04-19  |  7KB  |  149 lines
  1.  
  2.   05/24/92
  3.  
  4.     You may now run QWK/REP in what is called LOCAL mode. Don't
  5.     confuse this with logging onto the BBS system in local mode and
  6.     invoking QWK. It is a completely different concept.
  7.  
  8.     LOCAL mode is for those that wish to run QWK/REP in an unattended
  9.     environment (i.e., an Event batch file). It also supports several
  10.     Networking features.
  11.  
  12.     When run in LOCAL mode, QWK/REP will not issue any prompts. In
  13.     QWKEXPRT, the Menu will not appear, nor will you be given the
  14.     opportunity to select any Forums. It is a completely automated
  15.     system whereby QWKEXPRT will export any new messages and place the
  16.     QWK packet into a directory that you specify on the command line.
  17.     REPIMPRT will automatically import messages from a REP file that
  18.     is contained in the directory that you specify on the command
  19.     line.
  20.  
  21.     LOCAL mode does not use the Sysop's user record (or any other legitimate
  22.     user's record). This keeps the message pointers of the "LOCAL person"
  23.     separate from those of real users.
  24.  
  25.     When exporting messages, LOCAL mode will NOT export ANY Comments
  26.     or any messages that are NOT flagged as echo mail messages.
  27.  
  28.     When importing messages, LOCAL mode will set the high message
  29.     number of the "special user" to the highest number in each of the
  30.     message bases.
  31.  
  32.  
  33.     The first step in setting up LOCAL mode is to go into the User Editor
  34.     and create a new user called QWK REP:
  35.  
  36.       First    : QWK
  37.       Last     : REP
  38.       Password : Something you can remember
  39.  
  40.     This user is basically your Master QWK/REP user and can be considered
  41.     to be the same as the Sysop but with its own user record.
  42.  
  43.     It is not necessary to register this user in any Forums unless you
  44.     intend to export messages from a Private Forum. If that is the case,
  45.     just register the user in those private Forums. The reason you do not
  46.     want to register the user in the Public Forums is because you will
  47.     have to enter into QWKREP and select the Forums you want this user to
  48.     be able to Export, so you will save yourself double work by not
  49.     pre-registering the user in the public Forums (QWKEXPRT will allow
  50.     the user to select any Forum that is public, whether the user is a 
  51.     member or not).
  52.  
  53.     After creating the QWK REP user, you will next need to log on locally
  54.     as this user and invoke the QWK command. The reason you have to log
  55.     on as this user this one time is because in LOCAL mode, you will not
  56.     have an opportunity to select any Forums. At the QWKEXPRT Menu, choose
  57.     the Select Forums option and select those Forums that you want this 
  58.     LOCAL user to be able to Export. You may set 'Last Read' pointers if
  59.     you want or you may simply do an Export (after selecting all the
  60.     Forums) and discard the QWK packet.
  61.  
  62.       If you have a lot of Forums with a lot of messages in each Forum,
  63.       either option you choose will take some time. If you do an 
  64.       Export and discard the packet, you will end up with quite a large
  65.       packet and it will take some time to create it. If you choose
  66.       to set the high message pointer for each Forum, you will have 
  67.       to select each Forum individually and type in the high number.
  68.       Since you have to select each Forum any way, you might want to
  69.       spend the extra second typing in the high number. It is up to
  70.       you on how you set the inital high message pointers, but they
  71.       DO need to be set to the high message number to keep from 
  72.       exporting messages that have already been exported.
  73.  
  74.  
  75.     Your QWK REP user is now configured, and you may run QWKEXPRT in
  76.     LOCAL mode. To do so, you must pass 2 extra parameters on the 
  77.     command line to QWKEXPRT:
  78.  
  79.         QWKEXPRT CONFIG_FILE LOCAL QWK_DIRECTORY
  80.  
  81.         1 - CONFIG_FILE is the name of the QWKEXPRT configuration file.
  82.         2 - LOCAL is the flag that tells QWKEXPRT to run in unattended
  83.             mode.
  84.         3 - QWK_DIRECTORY is the directory you want QWKEXPRT to place
  85.             the QWK packet in. Do NOT use the root directory or you
  86.             will find that the QWK packet will end up in the directory
  87.             that you invoked QWKEXPRT from.
  88.  
  89.         As an Example:
  90.  
  91.            QWKEXPRT QWKREP1.CNF LOCAL D:\QWK
  92.  
  93.     A QWK packet will be created automatically. The QWK ID will be the
  94.     one that is contained in your QWK configuration file.
  95.  
  96.     Note that a QWK packet will be created even if there are NO MESSAGES.
  97.     The MESSAGES.DAT in this situation will contain only the 128 byte
  98.     header record. The packet is created so that automated systems will
  99.     not "break" at the absence of a QWK packet. Any program that is 
  100.     used to read the QWK packet should be able to detect that there is
  101.     only a single 128 byte header and no messages and work without
  102.     failing.
  103.  
  104.  
  105.     To import messages, you must pass 2 extra parameters on the 
  106.     command line to REPIMPRT:
  107.  
  108.         REPIMPRT CONFIG_FILE LOCAL REP_DIRECTORY
  109.  
  110.         1 - CONFIG_FILE is the name of the REPIMPRT configuration file.
  111.         2 - LOCAL is the flag that tells REPIMPRT to run in unattended
  112.             mode.
  113.         3 - REP_DIRECTORY is the directory you want REPIMPRT to look
  114.             in to find the REP packet. Note that you do NOT append
  115.             the name of the REP packet to this directory path since
  116.             REPIMPRT will use your NODEID.REP as the name.
  117.  
  118.         As an Example:
  119.  
  120.            REPIMPRT QWKREP1.CNF LOCAL D:\REP
  121.  
  122.     An REP packet will be imported automatically.
  123.  
  124.     All incomming messages will be flagged as having come IN from a
  125.     network. This prevents the same messages from being exported
  126.     (which causes duplicates and cross-linking of networks).
  127.  
  128.     On Export, any messages that are TO SYSOP will be changed to
  129.     use the Sysop's real name as specified on line 9 of the
  130.     configuration file. On Import, any messages that are to the
  131.     Sysop's real name will be changed to SYSOP.
  132.  
  133.     Note that the LOCAL mode is NOT the same as Networking Mode. It
  134.     is very similar in many respects (only messages with the 'echo'
  135.     flag set will be exported), but it continues to write a QWK packet
  136.     and read a REP packet. Networking Mode is just the opposite in
  137.     that it writes a REP packet and reads a QWK packet (a node in
  138.     a QWK/REP network needs a QWK packet to send to its Hub).
  139.  
  140.     Note that a DOOR.SYS file is not utilized in LOCAL mode. 
  141.  
  142.     LOCAL mode is for specialized uses such as interfacing to FIDO
  143.     messages.
  144.  
  145.     CAUTION: Do not specify the QWKREP Work directory as the 
  146.     location for the QWK and REP packets as this directory is
  147.     automatically cleared when either program is run.
  148.  
  149.